home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 4 / CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso / magazine / psion / new / funzip13.lzx / unzip.txt < prev   
Text File  |  1981-01-17  |  16KB  |  551 lines
  1. Unzip v1.3 (Archive: FUNZIP13.ZIP)
  2. ==================================
  3.  
  4. This is a freeware user-friendly shell (front-end)
  5. for the UNZIP.IMG image file from David Palmer.
  6. The UNZIP.IMG file can be found on CompuServe in
  7. the Palmtop forum library 18 in different versions
  8. (see the Installation section below)
  9.  
  10. As with any freeware, I disclaim any liability
  11. whatsoever for problems created by this program.
  12. Although it works fine on my Psion 3a computers,
  13. I do not guarantee that this program is error
  14. free and I will not be held responsible for any
  15. damage or loss of any kind whatsoever.
  16.  
  17.         *** USE AT YOUR OWN RISK ***
  18.  
  19. That said, I believe I have found all bugs and that
  20. Unzip is stable and reliable.
  21.  
  22. I wrote this application as I could never remember
  23. the command line options I needed to unzip files.
  24. As David had kindly added full OPL launch support
  25. from version 1.4 of his UNZIP.IMG, I was inspired
  26. to create this very useful shell for David's unzip
  27. utility.
  28.  
  29. Unzip can be used as a replacement for, or a
  30. supplement to David Palmer's RUN.APP.
  31.  
  32.  
  33.  
  34. New Features in This Version (v1.3)
  35. ===================================
  36. * One small bug fix from v1.2
  37. See the change history at then end of this file
  38. for exact change details.
  39.  
  40.  
  41.  
  42. Archive Contents
  43. ================
  44. When you unzipped this file you should have
  45. found:
  46.  
  47.    File      Size Time    Date
  48.  UNZIP.TXT  16211 01:30 09-Aug-96 (this file)
  49.  UNZIP.OPA   2934 01:30 09-Aug-96 (series 3a app)
  50.  UNZIP.HLP   1689 01:30 09-Aug-96 (help file)
  51.  UNZIP.CLS   2394 01:30 09-Aug-96 (series 3 app)
  52.  
  53.  
  54.  
  55. Installation
  56. ============
  57. NOTE: If you have a series 3 (not a 3a) then 
  58. please read the Variants of UNZIP.OPA section
  59. towards the end of this file before proceding
  60. any further.
  61.  
  62. 1. Make sure you have v1.50 of the UNZIP.IMG file.
  63.    UNZIP.IMG is part of the complete unzip package
  64.    from David Palmer, which is available as...
  65.  
  66.      Archive         UNZIP.IMG Version
  67.     S3UZ150L.ZIP       v1.50l (preferred)
  68.     S3UZ150S.ZIP       v1.50s
  69.     S3UNZIP.ZIP        v1.50l & v1.50s
  70.  
  71.      File             Version
  72.     UNZIP.IMG          v1.50l
  73.  
  74.    ...in the CompuServe Palmtop forum's library 18.
  75.    You can also get UNZIP.IMG v1.50 by anonymous
  76.    ftp from
  77.    ftp://sunsite.doc.ic.ac.uk/computing/systems/
  78.    handhelds/psion/icdoc/utils/s3uzip15s.zip or
  79.    s3uzip15l.zip
  80.    For a detailed explanation of the difference
  81.    between v1.50l and v1.50s, see the section
  82.    "Variants of UNZIP.IMG" later on in this file.
  83.  
  84. 2. Series 3 users only: 
  85.    Delete the supplied UNZIP.OPA (it is not
  86.    required) and rename the file UNZIP.CLS 
  87.    to UNZIP.OPA
  88.  
  89. 3. Copy UNZIP.OPA into the *same* directory as
  90.    UNZIP.IMG
  91.    To retain compatibility with RUN.APP, use a
  92.    \RUN\ directory.
  93.    If you do not have RUN.APP installed (or wish
  94.    to remove it) then I recommend to copy the
  95.    files including UNZIP.IMG to an \APP\UNZIP\
  96.    directory.
  97.    NOTE: UNZIP.OPA will not work unless it is in
  98.    the same directory and on the same disk as
  99.    UNZIP.IMG.
  100.    The file *must* be named UNZIP.OPA
  101.  
  102. 4. Series 3a users only: 
  103.    If you wish to access online help for UNZIP.OPA,
  104.    then copy UNZIP.HLP into the same directory as
  105.    UNZIP.OPA.
  106.    Online help is optional: if you already know
  107.    how to unzip and wish to save memory space,
  108.    you may omit the help file.
  109.  
  110. 5. Install the UNZIP.OPA application from the
  111.    system screen by using Psion-I, pressing Tab,
  112.    and navigating to the directory where Unzip is
  113.    located.
  114.  
  115.    NOTE: all you need to unzip is UNZIP.IMG and
  116.    UNZIP.OPA. For the optional online help you
  117.    also need UNZIP.HLP. All other files in David
  118.    Palmer's archive can be deleted from the Psion
  119.    if you need to save precious memory space.
  120.  
  121.  
  122.  
  123. Operation
  124. =========
  125. Unzip contains a simple dialog for selecting the
  126. usual unzip options.
  127. All options provided by UNZIP.IMG v1.50 are
  128. supported by the Unzip shell.
  129. When you start Unzip (the same way as you would
  130. start any other application) you will see a dialog
  131. that will look like this...
  132.  
  133.  
  134.          Unzip v1.3    [Esc] to exit
  135.  
  136.  Unzip from file: Name    <file>
  137.                   Disk    Internal
  138.  Unzip to directory: Name \
  139.                      Disk Internal
  140.  Action:                  Extract files
  141.  File types:              All (*.*)
  142.  Overwrite:               Prompt
  143.  Options:                 None
  144.  
  145. NOTE: The example shows the series 3a variant, the
  146. series 3 variant looks slightly different.
  147. If you get any error messages on startup, see the
  148. section "Solving Problems" later on in this file.
  149.  
  150. If you have UNZIP.IMG v1.50s then the dialog title
  151. will also show "(for PKZIP v2.x only)" indicating
  152. that only archives created with PKZIP version 2.0
  153. and later can be unzipped (see "Variants of
  154. UNZIP.IMG" later on in this file).
  155.  
  156. Pressing [Esc] from the dialog will exit Unzip and
  157. save the last used directories to an UNZIP.INI
  158. file. The UNZIP.INI file will be created on your
  159. default disk if it does not already exist.
  160.  
  161. Press [Help] from the dialog to access the optional
  162. online Help. If you did not install the UNZIP.HLP
  163. file, then the author information will be displayed
  164. instead.
  165.  
  166.  
  167.  
  168. Unzip's Dialog
  169. ==============
  170. Unzip from file
  171. ---------------
  172. Unzip displays files initially in the \ (root)
  173. directory on your default disk.
  174. Press [Tab] to bring up the file selector to
  175. select any file you wish.
  176. You can also access remote drives on your PC using
  177. either PsiWin or RCom - see the section "Accessing
  178. Remote Drives with Unzip" later on in this file.
  179. When Unzip exits, it saves the last used directory
  180. in the UNZIP.INI file.
  181.  
  182.  
  183.  
  184. Unzip to directory
  185. ------------------
  186. Unzip will initially unzip to \ on your default
  187. disk.
  188. Press [Tab] for the file selector to select any
  189. other directory.
  190. You can also unzip to remote drives on your PC
  191. using either PsiWin or RCom - see the section
  192. "Accessing Remote Drives with Unzip" later on in
  193. this file.
  194. When Unzip exits, it saves the last used directory
  195. in the UNZIP.INI file.
  196.  
  197.  
  198.  
  199. Action
  200. ------
  201. Extract files (default)
  202.  This will extract all the zipped files in the
  203.  archive.
  204.  
  205. Update existing & create new
  206.  This will unzip files only if the zipped files
  207.  have a timestamp which is newer than the
  208.  existing files in the destination directory
  209.  (existing files will be overwritten), and it will
  210.  also create any new files that do not exist.
  211.  This is a good choice if you want to unzip an
  212.  archive directly to a flash SSD. Unchanged files
  213.  will *not* be overwritten, thus saving precious
  214.  flash SSD space.
  215.  
  216. Freshen (update existing only)
  217.  This does the same as above except that *no* new
  218.  files are created.
  219.  This is the best choice if you wish to update an
  220.  existing program but you do *not* want to unzip
  221.  files that you do not have installed (eg: text
  222.  files and optional files).
  223.  A good choice when unzipping a newer program
  224.  version directly to a flash SSD.
  225.  NOTE: UNZIP.IMG complains if you choose this
  226.  action together with the overwrite option "Never".
  227.  
  228. Test archive integrity
  229.  Test to see if the archive's files are not
  230.  corrupted and if they can be unzipped OK by
  231.  UNZIP.IMG .
  232.  
  233. Display archive comment
  234.  Does just that.
  235.  NOTE: many archives do not use the comment
  236.  feature however FUNZIP12.ZIP does!
  237.  
  238. List files (short)
  239.  Displays all the files in the archive showing
  240.  just size, date, time and name.
  241.  
  242. List files (long)
  243.  This does the same as the short list but displays
  244.  a bit more information about each file.
  245.  
  246. Create file list (short)
  247.  Creates a "\WRD\Filelist.wrd" file on your
  248.  default disk containing the short file list.
  249.  The file list is overwritten each time.
  250.  This is very useful to see what files are in the
  251.  archive, and as the file list is viewed in Word,
  252.  gives a better display (especially when the
  253.  archive contains many files) then the "List files"
  254.  above. You can also print the file list from Word.
  255.  
  256. Create file list (long)
  257.  The same as above but with more information
  258.  about each file.
  259.  
  260.  
  261.  
  262. File types
  263. ----------
  264. All (*.*), Readme (readme.*), Text (*.txt),
  265. Text (*.doc), Word (*.wrd), Agenda (*.agn),
  266. Data (*.dbf), Sound (*.wve), Sheet (*.spr),
  267. World (*.wld), Executable (*.app),
  268. Executable (*.opa), Executable (*.opo)
  269.  You can select which files you wish to extract.
  270.  This is handy if you just wish to extract just
  271.  some files first (and maybe read them) before
  272.  extracting the rest of the files.
  273.  Only files that match the selected file type will
  274.  be extracted.
  275.  A match is made when:
  276.   * the archived filename is stored in all lower
  277.     or upper case (ie: readme.* or README.*)
  278.   * the first letter of the matching text is upper
  279.     case and the rest is lower case
  280.     (ie: Readme.*, *.Txt, *,Dbf, etc.)
  281.  You can check how the archived filenames are
  282.  stored by creating a file list.
  283.  
  284.  
  285.  
  286. Overwrite
  287. ---------
  288. NOTE: overwrite options do not apply to the
  289. "Create file list" action.
  290.  
  291. Prompt
  292.  Unzip will ask you what to do if it finds an
  293.  existing file when extracting.
  294.  
  295. Never
  296.  Unzip will *never* overwrite any existing files.
  297.  NOTE: UNZIP.IMG complains if you choose
  298.  overwrite together with "Action: Freshen (update
  299.  existing only)"
  300.  
  301. Always
  302.  Unzip will *always* overwrite existing files.
  303.  
  304.  
  305.  
  306. Options
  307. -------
  308. None
  309.  No options.
  310.  
  311. Discard paths
  312.  If the archive contains paths, normally they are
  313.  extracted and created when unzipping.
  314.  Choosing this option will *prevent* the paths
  315.  from being created, and all files will be
  316.  unzipped to the same directory.
  317.  
  318. Quiet operation
  319.  Prevents some text from being displayed on the
  320.  screen or saved to the file list.
  321.  
  322. Very quiet operation
  323.  Even quieter than quiet operation.
  324.  
  325.  
  326.  
  327. Illegal Combinations
  328. ====================
  329. UNZIP.IMG will complain if you select both
  330. "Action: Freshen (update existing only)" AND
  331. "Overwrite: Never"
  332.  
  333.  
  334.  
  335. Variants of UNZIP.OPA
  336. =====================
  337. The Unzip shell is enclosed in this archive
  338. in two variants:
  339.  
  340. UNZIP.OPA (2937 bytes)
  341.  Series 3a variant (v1.3)
  342.  For the series 3a only, will not run on the 
  343.  series 3. Full utilisation of series 3a
  344.  display size and help system.
  345.  
  346. UNZIP.CLS (2401 bytes)
  347.  Series 3 classic variant (v1.3c)
  348.  Pruned-down variant for the series 3. Will
  349.  run on the series 3a as well, but 3a users are
  350.  encouraged to install the 3a variant.
  351.  The classic variant is slightly different to
  352.  the series 3a variant:
  353.   * No help system possible (so do not 
  354.     install UNZIP.HLP)
  355.   * Main dialog split into two sections and 
  356.     some dialog text shortened due to display
  357.     space limitations
  358.  If you need to install the series 3 classic
  359.  variant, then rename the file UNZIP.CLS
  360.  to UNZIP.OPA and install as shown above in
  361.  the installation section.
  362.  All of the unzip features are supported in
  363.  the series 3 classic variant.
  364.  
  365.  
  366.  
  367. Variants of UNZIP.IMG
  368. =====================
  369. UNZIP.IMG v1.50 comes in two variants:
  370.  
  371. v1.50l (large variant, 42160 bytes, *preferred*)
  372.  Can extract files compressed with both PKZIP v1.x
  373.  and PKZIP v2.x
  374.  Install this variant if you have the space
  375.  available (highly recommended)
  376.  
  377. v1.50s (small variant, 32816 bytes)
  378.  Can only extract files compressed with PKZIP
  379.  v2.x. Attempting to extract files compressed
  380.  with PKZIP v1.x will produce "unknown compression
  381.  method" errors.
  382.  Unzip knows if you have v1.50s by displaying the
  383.  text "(for PKZIP v2.x only) in the dialog title.
  384.  Install this variant if you are short on memory
  385.  space and do not need to unzip PKZIP 1.x archives.
  386.  
  387.  
  388.  
  389. UNZIP.IMG Compatibility
  390. =======================
  391. This version of Unzip has been designed to work
  392. purely with v1.50s and v1.50l of UNZIP.IMG
  393. I have tested UNZIP.OPA with both versions of
  394. UNZIP.IMG...
  395.  
  396.   Version  Size   Time     Date
  397.    v1.50l  42160  01:50  13-Jun-96
  398.    v1.50s  32816  01:50  13-Jun-96
  399.  
  400.   s = small, for PKZIP 2.x only
  401.   l = large, for PKZIP 1.x and 2.x
  402.  
  403. ...and both work happily.
  404.  
  405. Older versions of UNZIP.OPA provide support for
  406. older UNZIP.IMG image files, see the change
  407. history below.
  408.  
  409.  
  410.  
  411. Solving Problems
  412. ================
  413. Error messages that show "Unzip" on the top of the
  414. screen and the Unzip icon are from the Unzip shell.
  415. Common error messages are:
  416.  
  417. "Unzip.img not found"
  418.  at startup means that the file UNZIP.IMG is not in
  419.  the same directory on the same disk as UNZIP.OPA.
  420.  Reinstall UNZIP.IMG v1.50 to the same place
  421.  as UNZIP.OPA
  422.  
  423. "Wrong Unzip.img"
  424.  at startup means that your UNZIP.IMG file is not
  425.  version v1.50.
  426.  Install UNZIP.IMG v1.50
  427.  
  428. "Error in UNZIP\M   Invalid name" or
  429. "Error in UNZIP\M   End of file"
  430.  at startup means that the UNZIP.INI file is
  431.  corrupt.
  432.  Delete UNZIP.INI (it is on your default disk)
  433.  The INI file will be recreated automatically.
  434.  
  435. "Error in UNZIP\M   Write protected"
  436.  after pressing [Enter] to continue from the
  437.  dialog means that the UNZIP.INI file cannot be
  438.  written as the default disk is write protected.
  439.  Change the default disk from the system screen.
  440.  
  441. "Error in UNZIP\M   File or device in use"
  442.  after pressing [Enter] to continue from the
  443.  dialog means that the UNZIP.INI file cannot be
  444.  written as it is being used by another program
  445.  (maybe you are viewing it with Word?)
  446.  Find the program using UNZIP.INI and exit it.
  447.  
  448.  
  449. Error messages that occur when "UnZip v5 for
  450. EPOC (version 1.50x)" is displayed are from the
  451. UNZIP.IMG file.
  452. Common error messages are:
  453.  
  454. "can't allocate the work area"
  455.  There is not enough free memory for the 
  456.  UNZIP.IMG file to run.
  457.  Close other applications and delete unnecessary
  458.  files to free up some disk memory.
  459.  UNZIP.IMG needs about 100k free memory to run.
  460.  
  461. "Cannot create [file]: write error or (disk full?)"
  462.  UNZIP.IMG could not unzip any more files as the
  463.  disk is most probably full.
  464.  Close other applications and delete unnecessary
  465.  files to free up some disk memory.
  466.  
  467. "End-of-central-directory signature not found"
  468.  The file you are trying to unzip is not a PKZIP
  469.  compatible archive.
  470.  Choose the correct file.
  471.  
  472. "error:  invalid response [x]"
  473.  UNZIP.IMG was asking you to press a certain key
  474.  and you pressed key [x] instead.
  475.  Press a correct key.
  476.  
  477. "unknown compression method"
  478.  Archive was probably created with PKZIP v1.x
  479.  and you are using UNZIP.IMG v1.50s.
  480.  Install v1.50 variant l.
  481.  
  482.  
  483.  
  484. Accessing Remote Drives with Unzip
  485. ==================================
  486. Accessing remote drives is possible with
  487. either PsiWin or RCom. MCLink has not been
  488. tested.
  489. Remote drives will always appear in the file
  490. selector prefixed with "REM::"
  491. NOTE: The default setting of PsiWin will not
  492. allow remote access of PC files from the
  493. Psion.
  494. You can change this by editing the
  495. PSIONPRC.INI file in the Windows directory,
  496. and removing the '-x' from the end of the 
  497. line "engine=prcenwin.exe -x"
  498.  
  499.  
  500.  
  501. Acknowledgements
  502. ================
  503. Full and grateful acknowledgements go to David
  504. Palmer of Edinburgh, Scotland, for his wonderful
  505. UNZIP.IMG and his excellent documentation.
  506.  
  507.  
  508.  
  509. Change History
  510. ==============
  511. 09-Aug-96 v1.3
  512.  Bug fix: File Types = Word now correctly
  513.  selects *.wrd files.
  514.  
  515. 21-Jun-96 v1.2
  516.  Created series 3 classic variant (v1.2c).
  517.  Reduced runtime memory requirements by 47%.
  518.  File selector now shows all files (* instead 
  519.   of *.zip).
  520.  Removed support for earlier versions of
  521.   UNZIP.IMG to force the user to upgrade to
  522.   v1.50 (s or l) and to reduce code size.
  523.  Added better error handling when trying to
  524.   find or detect the UNZIP.IMG file.
  525.  Changed the icon.
  526.  Unzip now remembers last directories used
  527.   in UNZIP.INI.
  528.  Added (optional) online help.
  529.  Added ability to extract certain "File types".
  530.  Added "Create file list" action.
  531.  Rearranged the dialog layout and changed some
  532.   dialog text.
  533.  
  534. 07-May-96 v1.1
  535.  Added support for UNZIP.IMG v1.0/1.2/1.3.
  536.  Renamed a couple of options and fixed a spelling
  537.   mistake.
  538.  Optimised code to make the .OPA as small as
  539.   possible.
  540.  
  541. 01-May-96 v1.0
  542.  Original version (only for UNZIP.IMG v1.41).
  543.  
  544.  
  545. -------------------
  546. Jochen Siegenthaler
  547. Zurich, Switzerland
  548. 09 August, 1996
  549. 100127.3167@compuserve.com
  550.  
  551.